home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 039a / rzsz1004.zip / SZ.DOC < prev    next >
Text File  |  1991-10-03  |  17KB  |  397 lines
  1.  
  2.  
  3.  
  4.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       sx, sb, sz - Send Files with ZMODEM, YMODEM, or XMODEM
  10.       zcommand, zcommandi -    Send COmmands with ZMODEM
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       sz [-++++aaaabbbbddddeeeeffffkkkkLLLLllllNNNNnnnnooooppppTTTTttttuuuuvvvvyyyyYYYYZZZZ] _f_i_l_e ...
  14.       sb [-ddddffffkkkkttttuuuuvvvv] _f_i_l_e ...
  15.       sx [-kkkkttttuuuuvvvv] _f_i_l_e
  16.       zcommand [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
  17.       zcommandi [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
  18.       sz -TT
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.       SSSSzzzz (send ZMODEM) uses    the ZMODEM, YMODEM or XMODEM error
  22.       correcting protocol to send one or more files    over a dial-in
  23.       serial port to a variety of programs running under PC-DOS,
  24.       CP/M,    Unix, VMS, and other operating systems.
  25.  
  26.       This is a copyrighted    shareware program.  Commercial use of
  27.       this program is subject to licensing conditions detailed in
  28.       the rz.c source code.     "Commercial Use" includes use of this
  29.       program to send files    to commercial and/or shareware
  30.       programs not published by Omen Technology INC.
  31.  
  32.  
  33.       This program is not designed to be called from _c_u(_1) _t_i_p(_1),
  34.       or other communications programs.  Unix flavors of Omen
  35.       Technology's Professional-YAM    communications software    are
  36.       available for    dial-out applications.
  37.  
  38.  
  39.       SSSSzzzz sends one or more files with ZMODEM protocol.
  40.  
  41.       ZMODEM greatly simplifies file transfers compared to XMODEM.
  42.       In addition to a friendly user interface, ZMODEM provides
  43.       Personal Computer and    other users an efficient, accurate,
  44.       and robust file transfer method.
  45.  
  46.       ZMODEM provides complete EEEENNNNDDDD----TTTTOOOO----EEEENNNNDDDD data integrity between
  47.       application programs.     ZMODEM's 32 bit CRC catches errors
  48.       that sneak into even the most    advanced networks.
  49.  
  50.       Advanced file    management features include AutoDownload
  51.       (Automatic file Download initiated without user
  52.       intervention), Display of individual and total file lengths
  53.       and transmission time    estimates, Crash Recovery, selective
  54.       file transfers, and preservation of exact file date and
  55.       length.
  56.  
  57.       The ----yyyy option    instructs the receiver to open the file    for
  58.       writing unconditionally.  The    ----aaaa option causes the receiver
  59.       to convert Unix newlines to PC-DOS carriage returns and
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 10/3/91)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       linefeeds.
  75.  
  76.  
  77.       SSSSbbbb sends one or more files with YMODEM or ZMODEM protocol.
  78.       The initial ZMODEM initialization is not sent.  When
  79.       requested by the receiver, ssssbbbb    supports YYYYMMMMOOOODDDDEEEEMMMM----gggg with
  80.       "cbreak" tty mode, XON/XOFF flow control, and    interrupt
  81.       character set    to CAN (^X).  YYYYMMMMOOOODDDDEEEEMMMM----gggg (Professional-YAM gggg
  82.       option) increases YMODEM throughput over error free channels
  83.       (direct connection, X.PC, etc.) by disabling error recovery.
  84.  
  85.       On Unix systems, additional information about    the file is
  86.       transmitted.    If the receiving program uses this
  87.       information, the transmitted file length controls the    exact
  88.       number of bytes written to the output    dataset, and the
  89.       modify time and file mode are    set accordingly.
  90.  
  91.  
  92.       SSSSxxxx sends a single _f_i_l_e with XXXXMMMMOOOODDDDEEEEMMMM or    XXXXMMMMOOOODDDDEEEEMMMM----1111kkkk protocol
  93.       (sometimes incorrectly called    "ymodem").  The    user must
  94.       supply the file name to both sending and receiving programs.
  95.  
  96.       Iff sssszzzz is invoked with $SHELL    set and    iff that variable
  97.       contains the string _r_s_h or _r_k_s_h (restricted shell), sssszzzz
  98.       operates in restricted mode.    Restricted mode    restricts
  99.       pathnames to the current directory and PUBDIR    (usually
  100.       /usr/spool/uucppublic) and/or    subdirectories thereof.
  101.  
  102.  
  103.       The fourth form sends    a single COMMAND to a ZMODEM receiver
  104.       for execution.  ZZZZccccoooommmmmmmmaaaannnndddd exits with the COMMAND return
  105.       value.  If COMMAND includes spaces or    characters special to
  106.       the shell, it    must be    quoted.
  107.  
  108.  
  109.       The fifth form sends a single    COMMAND    to a ZMODEM receiver
  110.       for execution.  ZZZZccccoooommmmmmmmaaaannnnddddiiii exits as soon as the receiver has
  111.       correctly received the command, before it is executed.
  112.  
  113.  
  114.       The sixth form (sz -TT) attempts to output all 256 code
  115.       combinations to the terminal.     In you    are having difficulty
  116.       sending files, this command lets you see which character
  117.       codes    are being eaten    by the operating system.
  118.  
  119.  
  120.  
  121.       The meanings of the available    options    are:
  122.  
  123.       ++++    Instruct    the receiver to    append transmitted data    to an
  124.            existing    file (ZMODEM only).
  125.       aaaa    Instruct    the ZMODEM receiver to convert text file
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 10/3/91)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.            format as appropriate for the receiving system.    Valid
  141.            only for    ZMODEM.
  142.       bbbb    (ZMODEM)    Binary override: transfer file without any
  143.            translation.
  144.       cccc    Instruct    the receiver to    change the pathname if the
  145.            destination file    exists.
  146.       dddd    Change all instances of "." to "/" in the transmitted
  147.            pathname.  Thus,    C.omenB0000 (which is unacceptable to
  148.            MSDOS or    CP/M) is transmitted as    C/omenB0000.  If the
  149.            resultant filename has more than    8 characters in    the
  150.            stem, a "." is inserted to allow    a total    of eleven.
  151.       eeee    Escape all control characters; normally only XON, XOFF,
  152.            DLE, CR-@-CR, and Ctrl-X    are escaped.
  153.       ffff    Send Full pathname.  Normally directory prefixes    are
  154.            stripped    from the transmitted filename.
  155.       kkkk    (XMODEM/YMODEM) Send files using    1024 byte blocks
  156.            rather than the default 128 byte    blocks.     1024 byte
  157.            packets speed file transfers at high bit    rates.
  158.            (ZMODEM streams the data    for the    best possible
  159.            throughput.)
  160.       LLLL NNNN  Use ZMODEM sub-packets of length    N.  A larger N (32 <=
  161.            N <= 1024) gives    slightly higher    throughput, a smaller
  162.            N speeds    error recovery.     The default is    128 below 300
  163.            baud, 256 above 300 baud, or 1024 above 2400 baud.
  164.       llll NNNN  Wait for    the receiver to    acknowledge correct data every
  165.            NNNN (32 <=    N <= 1024) characters.    This may be used to
  166.            avoid network overrun when XOFF flow control is
  167.            lacking.
  168.       nnnn    (ZMODEM)    Send each file if destination file does    not
  169.            exist.  Overwrite destination file if source file is
  170.            newer than the destination file.
  171.       NNNN    (ZMODEM)    Send each file if destination file does    not
  172.            exist.  Overwrite destination file if source file is
  173.            newer or    longer than the    destination file.
  174.       oooo    (ZMODEM)    Disable    automatic selection of 32 bit CRC.
  175.       pppp    (ZMODEM)    Protect    existing destination files by skipping
  176.            transfer    if the destination file    exists.
  177.       rrrr    (ZMODEM)    Resume interrupted file    transfer.  If the
  178.            source file is longer than the destination file,    the
  179.            transfer    commences at the offset    in the source file
  180.            that equals the length of the destination file.
  181.       rrrrrrrr   As above, but compares the files    (the portion common to
  182.            sender and reciever) before resuming the    transfer.
  183.       tttt ttttiiiimmmm
  184.            Change timeout to _t_i_m tenths of seconds.
  185.       uuuu    Unlink the file after successful    transmission.
  186.       wwww NNNN  Limit the transmit window size to N bytes (ZMODEM).
  187.       vvvv    Verbose causes a    list of    file names to be appended to
  188.            /tmp/szlog .  More v's generate more output.
  189.       yyyy    Instruct    a ZMODEM receiving program to overwrite    any
  190.            existing    file with the same name.
  191.       YYYY    Instruct    a ZMODEM receiving program to overwrite    any
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 10/3/91)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.            existing    file with the same name, and to    skip any
  207.            source files that do have a file    with the same pathname
  208.            on the destination system.
  209.       ZZZZ    Use ZMODEM file compression to speed file transfer.
  210.  
  211.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  212.       Exit status is as follows: 0 for successful transfers.  1 if
  213.       unrecoverable    errors are detected.  2    if syntax errors or
  214.       file access problems are detected.  3    if the program was
  215.       terminated by    a caught interrupt.
  216.  
  217.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  218.       ZZZZMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to    DSZ/ZCOMM/Professional-YAM)
  219.       %%%% sssszzzz ----aaaa ****....cccc
  220.       This single command transfers    all .c files in    the current
  221.       Unix directory with conversion (----aaaa) to end of    line
  222.       conventions appropriate to the receiving environment.     With
  223.       ZMODEM AutoDownload enabled, Professional-YAM     and ZCOMM
  224.       will automatically recieve the files after performing    a
  225.       security check.
  226.  
  227.       %%%% sssszzzz ----YYYYaaaannnn ****....cccc    ****....hhhh
  228.       Send only the    .c and .h files    that exist on both systems,
  229.       and are newer    on the sending system than the corresponding
  230.       version on the receiving system, converting Unix to DOS text
  231.       format.
  232.  
  233.       ZZZZMMMMOOOODDDDEEEEMMMM CCCCoooommmmmmmmaaaannnndddd DDDDoooowwwwnnnnllllooooaaaadddd (Unix    to Professional-YAM)
  234.        cpszall:all
  235.           zcommand "c:;cd /yam/dist"
  236.           sz -ya $(YD)/*.me
  237.           sz -yb y*.exe
  238.           zcommand "cd /yam"
  239.           zcommandi    "!insms"
  240.       This Makefile    fragment uses zzzzccccoooommmmmmmmaaaannnndddd to issue    commands to
  241.       Professional-YAM to change current disk and directory.
  242.       Next,    sssszzzz transfers the ._m_e files from    the $YD    directory,
  243.       commanding the receiver to overwrite the old files and to
  244.       convert from Unix end    of line    conventions to PC-DOS
  245.       conventions.    The third line transfers some ._e_x_e files.  The
  246.       fourth and fifth lines command Pro-YAM to change directory
  247.       and execute a    PC-DOS batch file _i_n_s_m_s    . Since    the batch file
  248.       takes    considerable time, the zzzzccccoooommmmmmmmaaaannnnddddiiii form is used to allow
  249.       the program to exit immediately.
  250.  
  251.       XXXXMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to    Crosstalk)
  252.       % ssssxxxx ffffoooooooo....cccc
  253.       EEEESSSSCCCC
  254.       rrrrxxxx ffffoooooooo....cccc
  255.       The above three commands transfer a single file from Unix to
  256.       a PC and Crosstalk.  This combination    is much    slower and
  257.       less reliable    than ZMODEM.
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 10/3/91)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  269.  
  270.  
  271.  
  272.      EEEERRRRRRRROOOORRRR MMMMEEEESSSSSSSSAAAAGGGGEEEESSSS
  273.       "Caught signal 99" indicates the program was not properly
  274.       compiled, refer to "bibi(99)"    in rbsb.c for details.
  275.  
  276.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  277.       rz(omen), ZMODEM.DOC,    YMODEM.DOC, Professional-YAM,
  278.       crc(omen), sq(omen), todos(omen), tocpm(omen), tomac(omen),
  279.       yam(omen)
  280.  
  281.       Compile time options required    for various operating systems
  282.       are described    in the source file.
  283.  
  284.      FFFFIIIILLLLEEEESSSS
  285.       32 bit CRC code courtesy Gary    S. Brown.
  286.  
  287.       sz.c,    crctab.c, rbsb.c, zm.c,    zmr.c, zmodem.h    Unix source
  288.       files
  289.  
  290.       /tmp/szlog stores debugging output (sz -vv)
  291.  
  292.      TTTTEEEESSSSTTTTIIIINNNNGGGG FFFFEEEEAAAATTTTUUUURRRREEEE
  293.       The command "sz -T file" exercises the AAAAttttttttnnnn sequence error
  294.       recovery by commanding errors    with unterminated packets.
  295.       The receiving    program    should complain    five times about
  296.       binary data packets being too    long.  Each time sssszzzz is
  297.       interrupted, it should send a    ZDATA header followed by
  298.       another defective packet.  If    the receiver does not detect
  299.       five long data packets, the AAAAttttttttnnnn sequence is not
  300.       interrupting the sender, and the MMMMyyyyaaaattttttttnnnn string in sssszzzz....cccc must
  301.       be modified.
  302.  
  303.       After    5 packets, sssszzzz stops the    "transfer" and prints the
  304.       total    number of characters "sent" (Tcount).  The difference
  305.       between Tcount and 5120 represents the number    of characters
  306.       stored in various buffers when the Attn sequence is
  307.       generated.
  308.  
  309.      NNNNOOOOTTTTEEEESSSS
  310.       When using TrailBlazer or other buffered modems at high
  311.       speed, particular attention must be paid to flow control.
  312.       The modem and    Unix must agree    on the flow control method.
  313.       Sz on    USG (SYS III/V)    systems    uses XON/XOFF flow control.
  314.       If flow control cannot be properly set up, Try a "-w 2048"
  315.       option to enforce protocol level flow    control.  Experiment
  316.       with different window    sizes for best results.
  317.  
  318.       Telebit modems must not be set to "spoof" UUCP, XMODEM, or
  319.       KERMIT.  Setting one of these    spoofing modes interferes with
  320.       other    protoocls.
  321.  
  322.       If a program that does not properly implement    the specified
  323.       file transfer    protocol causes    _s_b to "hang" the port after a
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 10/3/91)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      SSSSZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         SSSSZZZZ((((1111))))
  335.  
  336.  
  337.  
  338.       failed transfer, either wait for _s_b to time out or keyboard
  339.       a dozen Ctrl-X characters.  Every reported instance of this
  340.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  341.       other    program    with a correct implementation of the specified
  342.       protocol.
  343.  
  344.       Many programs    claiming to support YMODEM only    support    XMODEM
  345.       with 1k blocks, and they often don't get that    quite right.
  346.       XMODEM transfers add up to 127 garbage bytes per file.
  347.       XMODEM-1k and    YMODEM-1k transfers use    128 byte blocks    to
  348.       avoid    extra padding.
  349.  
  350.       YMODEM programs use the file length transmitted at the
  351.       beginning of the transfer to prune the file to the correct
  352.       length; this may cause problems with source files that grow
  353.       during the course of the transfer.  This problem does    not
  354.       pertain to ZMODEM transfers, which preserve the exact    file
  355.       length unconditionally.
  356.  
  357.       Most ZMODEM options are merely passed    to the receiving
  358.       program; some    programs do not    implement all of these
  359.       options.
  360.  
  361.       Circular buffering and a ZMODEM sliding window should    be
  362.       used when input is from pipes    instead    of acknowledging
  363.       frames each 1024 bytes.  If no files can be opened, sssszzzz sends
  364.       a ZMODEM command to echo a suitable complaint; perhaps it
  365.       should check for the presence    of at least one    accessible
  366.       file before getting hot and bothered.
  367.  
  368.      BBBBUUUUGGGGSSSS
  369.       On at    least one BSD system, sz would abend it    got within a
  370.       few kilobytes    of the end of file.  Using the "-w 8192" flag
  371.       fixed    the problem.  The real cause is    unknown, perhaps a bug
  372.       in the kernel    TTY output routines.
  373.  
  374.       The test mode    leaves a zero length file on the receiving
  375.       system.
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 10/3/91)
  394.  
  395.  
  396.  
  397.